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SDS PROGRAM LIBRARY 
PROGRAM DESCRIPTION 



Model No. 860799-11A00 



IDENTIFICATION: 

AUTHOR: 

ACCEPTED: 

COMPUTER 
CONFIGURATION: 

PURPOSE : 



NAA DES-1 Hybird Call Library 



SDS 



PROGRAMMED 
OPERATORS : 

SUBROUTINES 
REQUIRED : 

STORAGE : 

TIMING: 

SOURCE 
LANGUAGE : 

LOADING PROCEDURE: 

USE: 



August 23, 1968 



SDS 9300, DES-1, and Interface hardware 
for NAA System. 

The DES-1 Hybird Call Library consists 
of a number of subroutines which provide 
the DES-1 user control of the Hybird 
System hardware. 



None 

None 

N/A 
N/A 

SDS 9300 Metasymbol 

Called by DES-1 call statements 

GENERAL 

All of the routines of the DES-1 Hybird 
Call Library are subroutines which expect 
and return only floating point arguments. 
Reentrancy is taken care of by having 
duplicate copies of each of the routines. 
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USE: (cont.) GENERAL Cont, 



If the same routine is to be used in 
both RATE 1 and RATE 2 calculations, 
the number one version should be used in 
RATE 1 and the number two version should 
be used in RATE 2. Either version may 
be used in INITIAL calculations or if 
the routine is not used in both RATE 1 
and RATE 2 calculation. 

If external patchable interrupts are 
used, care must be exercised in their 
use. Since DES-1 is protected from 
the timing interrupt only, user int- 
errupt initiated subroutines must re- 
store any registers which are used and 
protect themselves from recursion. 

In all the following descriptions the ' 
n in the name must be either a 1 or 2 . 

A. INTERRUPT STATEMENTS . 

1. CALL EIRn 

All system interrupts are enabled. 

2. CALL DIRn 

All system interrupts are disabled. 

3. CALL ARMn (I ,. I , I, , ...) 

i J k 

Interrupts I . I , I, 9 etc., are 
armed. 

Error messages: 

a. ERR ARM - Occurs when an 

interrupt number is outside 
the allowable range (0-31) . 
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USE: (cont.) A. INTERRUPT STATEMENTS, 



4. CALL DRMn (I., I., I , . ..) 

Interrupts I # ,I., I . etc., are 
disarmed . 



Error messages: 

a. ERR DRM - Occurs when an 

interrupt number is outside 
the allowable range (0-31). 

CALL IDLn 

The machine halts waiting for an 
interrupt. After any interrupt has 
occurred and been processed, the flow 
of control passes to the next state- 
ment. 



6. CALL NULn (I., I., I,, . . .) 

i J k 

Interrupt 1,1,1,, etc., are tied 

iik 
to the briefest possible clear and 

return routine. 
Error messages: 



a. ERR NUL - Occurs when an 

interrupt number is outside 
the allowable range, (0-31). 

7. CALL INTn (I) 

This subroutine returns a plus one 

if all system interrupts are disabled, 

and a minus one if they are enabled. 



Page 4 of 7 


Model No. 860799-llAOO 


USE: (cont.) 


B. DIGITAL-ANALOG CONVERSION INSTRUCTIONS 




1. CALL DACn (L , V , L , V , . . .) 
i i J J 




The values of V., V., etc. , are out- 




put as analog voltages on channels 




L., L., etc., of the ditital-to-analog 




conversion system. The V ! s must lie 




in the range 1.0 > v > -1.0 




representing percentage of full scale. 




Error messages.: 




a. ERR DAC - INSUFFICIENT 




DATA - Occurs if the number 




of arguments is odd. 




b. ERR DAC - INVALID CHAN 




NO. - Occurs if L is outside 




the allowable range, (0-47) . 




c. ERR DAC - VALUE OUT OF 




LIMITS - Occurs if V is 




outside the allowable range. 




2. CALL ADCn (L .. , V , L., V., ...) 
i i' J J 




Channels L., L., etc., of the analog- 
to-digital conversion system are read 






and the values assigned as floating 




point numbers to the variables V., 




V., etc. The return arguments will 




lie in the range 1.0 >v > - 1.0 




representing percentage of full 




scale. 




Error messages: 




a. ERR DAC - INSUFFICIENT 




DATA - Occurs if the miumber 




of arguments is odd. 




b. ERR ADC - INVALID CHAN 




NO. - Occurs if L is outside 




the allowable range (0-79). 
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USE: (cont.) C. ANALOG COMPUTER INSTRUCTIONS 

1. CALL CONn (N) 

Analog Console N is selected. 
Error messages: 

a. ERR CNS - Occurs if N is 
outside the allowable range 
(0-7). 

b. ERR CNS - CONSOLE NOT 
SELECTED - Occurs if console 
N cannot be selected within 
100 ms. 

2. CALL MODn (M., M., ) 

Analog console N is placed in modes 

M., M . ...) • 
i J 

Error messages: 

a. ERR MODE - Occurs if an M 
is outside the allowable 
range (0-10). 

b. ERR MODE - CONSOLE - MODE 
NOT SELECTED - 

Occurs if the console N or 
a mode M cannot be selected 
within 100 ms . 

The modes are as follows: 






= 


Operate 


1 


= 


Hold 


2 


= 


Reset 


3 


= 


Static test 


4 


= 


Pot set 


5 


= 


Rate test 


6 


= 


IMC #1 


7 


= 


IMC #2 


8 


= 


IMC #3 


9 


= 


IMC #4 


10 


= 


IMC #5 
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USE: (cont.) C. DIGITAL -ANALOG CONVERSION INSTRUCTIONS 

3. CALL SCNn (M . V., M., V., . . .) 
i V J J 

The specified elements M . M . etc.. 

in 
of analog console N are read and the 

values assigned to the associated 
variables V., V., etc., in floating 
point format. The return arguments 
will lie in the range of 1.0 >v> - 
1.0 representing percentage of full 
scale. In the argument list, M f s are 
three digit integers made up of the 
category (first digit of integer 
from the following table) and a two- 
digit unit address. 



First Integer 




Digit 


Category 





Resolvers 


1 


Multipliers 


2 


Function 




Generators 


3 


Integrator Check 




Points 


4 


Amplifiers 


5 


Trunks 


6 


Potentiometers 




(First 100) 


7 


Potentiometers 




(Second 100) 



Error messages: 

a. ERR SCN - INSUFFICIENT 
DATA - Occurs if the number 
of arguments is odd. 

b. ERR SCN - INVALID CATEGORY 
XXXX - Occurs if category XXXX 
is not from the above table. 



Page 7 of 7 Model No. 860799-11A00 



USE: (cont.) C. DIGITAL -ANALOG CONVERSION INSTRUCTIONS. 

3. Cont. 

c. ERR SCN - INVALID UNIT 

ADDRESS XXXX - Occurs if 

the address is outside of the 

allowable range (0-79) . 

D. LINKAGE INSTRUCTIONS 

1. CALL TSTn (L . L L, , ...,V) 

i j k 

This subroutine returns a minus one 
in V if any one of the sense lines 
L . L. L, . has a true signal on it. 
and a plus one if not. 

Error messages: 

a. ERR TST - Occurs when a line 

number is outside the allowable 
range (0-51) . 

2. CALL SETn (L , M. L., M , ) 

i i J J 

Level output lines L., ~L., etc., are 
placed in the state determined by M., 
M., etc. The "on" state is represented 
by minus one, and the "off 1 state is 
represented by plus one. 

Error messages: 

a. ERR STL - INSUFFICIENT DATA 
- Occurs if the number of 
arguments is odd. 

b. ERR STL - INVALID LINE NO. - 
Occurs when a line number is 
outside the allowable range 
(0-51). 



